home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / xfer39.arc / TRANSFER.DOC < prev    next >
Text File  |  1990-12-11  |  10KB  |  275 lines
  1.  
  2.                                TRANSFER
  3.  
  4.                               Version 3.9
  5.  
  6.                       Copyright 1990-Steve Lewis
  7.  
  8.  
  9.  
  10.  
  11.  
  12. READ E-V-E-R-Y-T-H-I-N-G! THERE ARE IMPORTANT DIFFERENCES BETWEEN THIS VERSION
  13. AND PREVIOUS VERSIONS!
  14.  
  15. Version 3.9 has AUTOMATIC protocol-file seeking. It will AUTOMATICALLY detect
  16. the presence of the necessary files.
  17.  
  18. NOTE:THE TRANSFER.CFG FILE FOR VERSIONS 3.8 AND BELOW ARE NOT COMPATIBLE WITH
  19. THIS VERSION! BEFORE USING VERSION 3.9, RE-CREATE THE TRANSFER.CFG FILE BY
  20. RUNNING THE N-E-W VERSION OF TRANSCFG.EXE!
  21.  
  22. WHEN BATCH UPLOADING WITH THE MEGALINK PROTOCOL, A-L-L FILENAMES MUST BE
  23. FROM THE S-A-M-E DIRECTORY. THE DIRECTORY OF THE FIRST FILENAME MUST BE THE
  24. DIRECTORY FOR ALL THE OTHERS. THIS LIMITATION IS DUE TO THE MLINK.EXE
  25. PROTOCOL, AND NOT DUE TO THE "TRANSFER.EXE" PROGRAM.
  26.  
  27. WHEN CHANGING VERSIONS OF TRANSFER.EXE, A-L-W-A-Y-S CHANGE THE FOLLOWING
  28. FILES AS WELL;
  29.  
  30.                                TRANSCFG.EXE
  31.                                MAKBATCH.EXE
  32.  
  33.                   ..... BECAUSE THEY MAY DIFFER FROM THOSE
  34.                         PACKED WITH THE PREVIOUS VERSION OF
  35.                         TRANSFER.EXE !!!
  36.  
  37. TRANSFER was written primarily as a file transfer shell for a communications
  38. program. If you are using PCPLUS, configure PCPLUS so you can shell out
  39. to TRANSFER by using the <ALT>J or <ALT>U keys.
  40.  
  41. TRANSFER can be used in the MODEM mode, or in the DIRECT mode by using a
  42. "Null Modem" cable. In the MODEM mode, TRANSFER assumes that communications
  43. have already been established by the communications program, therefore,
  44. neither the modem nor COM port are initialized. In the DIRECT mode, TRANSFER
  45. allows the user to initialize the COM port if the user chooses to do so. In
  46. this case, the COM port will be intialized to 8-bits, 1 stop bit, no parity,
  47. at a speed specified by the user. COM ports 1-4 are supported.
  48.  
  49. The following transfer protocols are supported by TRANSFER;
  50.  
  51.  
  52.                       (1)  Xmodem/CHK SUM
  53.                       (2)  Xmodem/CRC
  54.                       (3)  Ymodem/(1K Xmodem)
  55.                       (4)  Ymodem/CRC
  56.                       (5)  Ymodem-G
  57.                       (6)  Ymodem/Batch
  58.                       (7)  Jmodem
  59.                       (8)  Jmodem/Batch
  60.                       (9)  Zmodem/Batch  (NEW Zmodem-90)
  61.                       (10) Super8K
  62.                       (11) Super8K/Batch
  63.                       (12) Super8K-G
  64.                       (13) Super8K-G/Batch
  65.                       (14) K9Xmodem
  66.                       (15) K9Xmodem/Batch
  67.                       (16) Cmodem
  68.                       (17) Cmodem/Batch
  69.                       (18) WXmodem
  70.                       (19) WXmodem/Batch
  71.                       (20) Tmodem/Batch
  72.                       (21) PUMA/Batch
  73.                       (22) Nmodem
  74.                       (23) Nmodem/Batch
  75.                       (24) Megalink/batch
  76.  
  77.  
  78.                            *INSTALLATION*
  79.  
  80.  
  81. XFER39.ZIP contains four files;
  82.  
  83.                                 TRANSFER.EXE                   
  84.                                 TRANSFER.DOC
  85.                                 TRANSCFG.EXE
  86.                                 MAKBATCH.EXE              
  87.  
  88. On some Bulletin Boards, the files may be contained in XFER39.LZH or 
  89. XFER39.ARC.
  90.  
  91.  
  92.  
  93. TRANSFER.EXE requires the following files to operate;
  94.  
  95. DSZ.COM (or DSZ.EXE) * (Required for Protocols #5, #6, #9)
  96. SUPERK.COM * (Required for Protocols #1-#3, #10-#19)
  97. SUPERK.000 * (Comes w/SUPERK.COM) (Required for Protocols #1-#3, #10-#19)
  98. JMODEM.COM (or JMODEM.EXE) * (Required for Protocols #7, #8)
  99. TMODEM.EXE * (Required for Protocol #20)
  100. PUMA.EXE   * (Required for Protocol #21)
  101. NMODEM.EXE * (Required for Protocols #22, #23)
  102. CMODEM.EXE * (Comes w/SUPERK.COM) (Required for Protocols #16, #17)
  103. MLINK.EXE  * (Required for Protocol #24)
  104. TRANSFER.EXE
  105. TRANSFER.BAT (Created by TRANSCFG.EXE)
  106. TRANSFER.CFG (Created by TRANSCFG.EXE)
  107. MODE.COM   * (DOS file-Resides in DOS directory)
  108. BATCHFLE     (Optional. Created by MAKBATCH.EXE)
  109.  
  110. *=USER SUPPLIED!
  111.  
  112.  
  113.                            VERY IMPORTANT---READ!!!
  114.  
  115. The TRANSFER.EXE program needs to be able to locate the TRANSFER.CFG program
  116. in order to operate. Version 3.9 of TRANSFER automatically creates a batch
  117. file named TRANSFER.BAT, and places it in the root directory. This batch
  118. file automatically changes the drive and directory to the location of the
  119. TRANSFER.EXE and TRANSFER.CFG files, which must exist in the SAME directory.
  120. All the transfer protocol files may exist in ONE separate directory. If
  121. SUPERK.COM and SUPERK.000 do not exist in the same directory as TRANSFER,
  122. then SUPERK.COM must be configured so that it can find its overlay file,
  123. SUPERK.000. To do this, type SUPERK @, which will bring SUPERK into the
  124. Configuration Mode, and then specify both the "wrkpath" to SUPERK.COM and the
  125. "Ovlpath" to SUPERK.000. They must BOTH be set to point to the directory where
  126. the SUPERK and other protocol files reside. If the directory is named "FILES",
  127. then SUPERK expects the two paths to be shown in the following format;
  128.  
  129.  
  130.                               C:\FILES\
  131.  
  132.  
  133. Note that when running TRANSCFG.EXE, the path to the above directory
  134. must be entered in the following format;
  135.  
  136.  
  137.                               C:\FILES  (NO ending backslash!!!)
  138.  
  139.  
  140. NOTE:TO TAKE FULL ADVANTAGE OF THE FEATURES OF THE USER-SUPPLIED PROTOCOL
  141.      PROGRAMS, ALWAYS USE REGISTERED VERSIONS OF THESE PROGRAMS!!!!!!!
  142.  
  143.      UNREGISTERED VERSIONS OF NMODEM WILL N-O-T SUPPORT FILE TRANSFERS
  144.      OUTSIDE OF THE DIRECTORY THAT NMODEM RESIDES IN!
  145.  
  146.      LATER VERSIONS OF THE PUMA PROTOCOL HAVE BEEN RENAMED "MPT.EXE", RATHER
  147.      THAN "PUMA.EXE". TO USE THESE LATER VERSIONS, SIMPLY RENAME THE
  148.      "MPT.EXE" FILE; "PUMA.EXE".
  149.  
  150.  
  151.      When uploading in Cmodem, if the file is located in the root directory,
  152.      it must be entered as;
  153.  
  154.  
  155.                              C:\\FILENAME
  156.  
  157.                      Yes, TWO backslashes are used!
  158.  
  159.  
  160.      If "FILENAME" were located in the directory C:\TEST\ , then you would
  161.      specify it as;
  162.  
  163.                              C:\TEST\FILENAME
  164.  
  165.  
  166.      A-L-W-A-Y-S READ THE DOCUMENTATION FOR THE PROTOCOL DRIVER YOU ARE USING,
  167.      IN ORDER TO KNOW ITS LIMITATIONS!
  168.  
  169.  
  170.  
  171. The reason why JMODEM.COM, rather than SUPERK.COM is used for Jmodem file
  172. transfers is because the writer of TRANSFER has been unable to get
  173. SUPERK.COM to operate properly in the Jmodem mode.
  174.  
  175.  
  176. The TRANSFER.CFG file is created by using the TRANSCFG.EXE configuration
  177. program. To run the program, simply type "TRANSCFG" and enter the requested
  178. information. The configuration program creates the configuration file, named
  179. TRANSFER.CFG, which MUST be present for TRANSFER to operate, as well as
  180. TRANSFER.BAT, which is placed in the root directory of the drive where the
  181. TRANSFER files reside.
  182.  
  183.  
  184. If the download directory is named FILES, and is a subdirectory of a directory
  185. named PCPLUS, it should be entered in the TRANSCFG program as;
  186.  
  187.                                 C:\PCPLUS\FILES
  188.  
  189. If the DOWNLOAD directory is a subdirectory of the root directory, it
  190. should be entered as;
  191.  
  192.                                 C:\FILES
  193.  
  194. If the DOWNLOAD directory is the root directory, simply enter the drive
  195. letter followed by a colon;
  196.  
  197.                                 C:
  198.  
  199.  
  200. Do NOT enter it as;
  201.  
  202.                                 C:\
  203.  
  204.  
  205. The above rules also apply for specifying the location of the protocol files,
  206. and the location of the TRANSFER files.
  207.  
  208.  
  209.  
  210.                   ************** IMPORTANT **************
  211.  
  212. TRANSFER.EXE WILL AUTOMATICALLY CHECK FOR THE PRESENCE OF THE NECESSARY
  213. PROTOCOL FILES. IT WILL CHECK FOR BOTH THE COM AND EXE VERSIONS OF THE SAME
  214. FILES. IT WILL ALSO CHECK FOR NECESSARY SUPPORTING FILES. IF THE REQUIRED
  215. FILES FOR A GIVEN PROTOCOL ARE NOT PRESENT IN THE DIRECTORY INDICATED IN THE
  216. CONFIGURATION FILE, THEN THE LISTING OF THAT PROTOCOL IN THE MENU WILL BE
  217. BLANKED OUT! KEEP IN MIND THAT IF AN ATTEMPT IS MADE TO SELECT ANY OF THE
  218. LOCKED-OUT PROTOCOLS, A MESSAGE WILL APPEAR, INFORMING THE USER THAT THE
  219. REQUIRED FILES ARE NOT PRESENT IN THE SPECIFIED DIRECTORY, AND TRANSFER WILL
  220. ABORT!
  221.  
  222. If it is desired to operate in the "TEXTFILE" mode, listing files to be
  223. uploaded in a textfile named BATCHFLE, then BATCHFLE needs to be created by
  224. running the MAKBATCH.EXE program. To run this program, simply type "MAKBATCH"
  225. and follow the instructions. This will AUTOMATICALLY cause the file BATCHFLE to
  226. be created, conforming to the following format;
  227.  
  228.  
  229.          <full path>\FILENAME1
  230.          <full path>\FILENAME2
  231.                     .
  232.                     .
  233.                     .
  234.          <full path>\FILENAMEn
  235.          ***<cr>                (The 3 asterisks denote the END of the list)
  236.  
  237.  
  238.  
  239. If TRANSFER is configured to operate in the "TEXTFILE" mode, rather than the
  240. "MANUAL" mode, then if a batch protocol is chosen and (U)pload is selected,
  241. file transfer will AUTOMATICALLY proceed, the files being chosen from the
  242. listing in BATCHFLE.
  243.  
  244.  
  245.  
  246.  
  247.         Written by Steve Lewis for the  IBM PC using DOS 2.0 or
  248.         later, including DOS 4.01
  249.  
  250.         TRANSFER is supplied for personal, private use. Feel free to
  251.         distribute TRANSFER given these restrictions:
  252.  
  253.           o  the program shall be supplied in its original,
  254.              unmodified form, which includes this documentation;
  255.  
  256.           o  no fee is charged.
  257.  
  258.           o  commercial use is prohibited.
  259.  
  260.           o  the program may not be included - or bundled - with
  261.              other goods or services. Exceptions may be granted
  262.              upon written request only.
  263.  
  264.         If you are using TRANSFER and find it of value, your gift in
  265.         any amount ($15 suggested) will be greatly appreciated.
  266.         Makes checks payable to:
  267.  
  268.                                  Steve Lewis
  269.                                  405 South Sunnyvale Ave.
  270.                                  #210
  271.                                  Sunnyvale, CA 94086
  272.  
  273.  
  274.  
  275.                          Voice: (415) 469-6604